Marble Blast Gold v. 1.6 for Mac OS X Release Notes
---------------------------------------------------

Thank you for purchasing Marble Blast Gold and supporting independent
game developers.  We hope you enjoy it!  Check back at GarageGames
for other great independent game titles.

Installation
------------

To install Marble Blast Gold, simply drag the Marble Blast Gold icon from
the install disk image to a folder on your computer.  Marble Blast Gold
will not work properly if you run it from the install disk image.

Contents
--------

Overview
What's New in the Gold edition of Marble Blast?
Registration
Controls
About GarageGames
About the Torque Game Engine
Troubleshooting

Overview
--------

Roll your marble through a rich cartoon landscape of moving 
platforms and dangerous hazards.  Along the way find power ups 
to increase your speed, jumping ability or flight power, and 
use them to collect the hidden gems and race to the finish for 
the fastest time.

What's New in the Gold edition of Marble Blast?
-----------------------------------------------

Marble Blast Gold adds 28 challenging new levels to the "Advanced" 
level category.  Every level also now has a "Gold" time - possible to
get, but very difficult.

Registration
------------

Marble Blast Gold uses the GarageGames Ignition technology for product
registration and validation.  In order to play Marble Blast Gold, you
will be required to validate your installation on any computers 
you wish to play Marble Blast Gold on.  If your computer is connected
to the internet, you can use the in-game registration system by
entering you product validation key in the registration dialog.

If the computer you wish to run Marble Blast Gold on is not connected to
the internet, or if you are having problems validating in-game, you
can use the out-of-game registration system by registering from
another computer at http://www.garagegames.com/ignition.  You will
then have to download a validation file and copy it to your
Marble Blast Gold installation.  Check http://www.garagegames.com/ignition
for details.

Controls
--------

All controls can be changed in the Options screen.

Roll Marble Forward - W
Roll Marble Backward - S
Roll Marble Left - A
Roll Marble Right - D

Jump - Space Bar
Use PowerUp - Mouse Button

Change Camera direction - Move Mouse - or

Look Up - Up Arrow
Look Down - Down Arrow
Turn Left - Left Arrow
Turn Right - Right Arrow

Free-Look Camera - E

You can turn free look on by default from the 
Options->Controls->Mouse screen.

About GarageGames
-----------------

GarageGames is a unique Internet publishing label for 
independent games and gamemakers.  Our mission is to provide 
the independent developer with tools, knowledge, co-conspirators - 
whatever is needed to unleash the creative spirit and get great 
innovative independent games to market.  Check back often at the
www.garagegames.com site for great independent games at reasonable
prices.

About the Torque Game Engine
----------------------------

The Torque Game Engine (TGE) is a full featured AAA title 
engine with the latest in scripting, geometry, particle effects, 
animation and texturing, as well as award winning multi-player 
networking code.  For $100 per programmer, you get the source to 
the engine that powers Marble Blast, Orbz, Sierra's Tribes 2, 
and many other titles currently in development.

Problems and Questions
----------------------

Listed below are some common questions and troubleshooting issues,
as well as possible solutions or workarounds:

Problem: My computer isn't connected to the internet!!! How do
I register Marble Blast?

Solution: See the registration section above.

Problem: I have a bunch of high scores from Marble Blast - how do I 
get them into Marble Blast Gold?

Solution: Ok, this is kind of convoluted... but here goes.  First, 
control-click on your original version of MarbleBlast OSX and choose
the menu item "Show Package Contents".  Open the "marble" folder
and then the "client" folder.  Select the files "prefs.cs" and
"prefs.cs.dso".  Choose "Copy 2 Items" from the Edit menu.  Next,
control-click on your new MarbleBlast Gold OSX application and choose
"Show Package Contents".  Open the "marble" folder, and then the
"client" folder.  Choose "Paste" from the Edit menu.  Overwrite any
previous versions of those files that may have been there.

Problem: I load up Marble Blast and the frame rate is SLOOOOWWW.

Solution: On older Macintosh computers, you may need to turn down
the resolution and bit depth for Marble Blast to run acceptably.
Go to the Options screen and select 640x480 at 16-bit color.

Problem: I have a really big/wide monitor and Marble Blast doesn't
let me access all the different resolution settings of my monitor!!!

Solution: You can manually set your fullscreen resolution from the
in-game console.  Press the tilde key (~) to access the console, and
then type: 
listResolutions();
This should display a list of all the resolutions your monitor and
video card support.  You can then set the resolution manually with
the setResolution() command like:
setResolution(1024, 640, 32); 
This will allow you to have Marble Blast take up the full screen
on wide screen iMacs and cinema displays.
Pressing the ~ again will cause the console to go away.

Problem: I've beaten all yer simplistic marble levels, and I want
some real challenges!

Solution: Well, you can either download other people's user created
levels (check the Marble Blast forums) or you can create your own
rockin' levels.

Problem: Uh, how do I make my own levels?

Solution: First, check out the Marble Blast level editing forum at
http://www.garagegames.com/index.php?sec=mg&mod=forums&page=result.forum&qf=84 .
That should get you pointed in the right direction.  You will need
a program that can edit Quake .map files (like QuArK or WorldCraft) in
order to create your own custom geometry.  Most if not all of these
programs are only available for Windows based machines.

Problem: Your easy listening music is cramping my marble style...
how do I play my own rockin' tunes in this game?

Solution: Marble Blast looks for files with the .ogg extension
in the Marble Blast application package.  To play your own tunes, 
just drop any ogg/vorbis encoded file (.ogg) into the Marble Blast
application package.  To open this folder, Control-click the Marble
Blast Icon and choose "Show Package Contents" from the pop-up menu.
If you want to get rid of the music that ships with the game, 
remove the .ogg files from the marble/data/sound folder within
the Marble Blast application package folder.

Problem: The Gold Time on level XYZ is way too low!  It is clearly
impossible to get such a low time!

Solution: Try again.  All of the gold times are possible to achieve
without cheating... but some of them are VERY hard to get.

Problem: I have some other problem other than the ones above.

Solution: Check the Marble Blast support forum at 
http://www.garagegames.com/marbleblast/

